----------------- Requirements -----------------
- At least version 1.113.291.1020 of The Sims 4 (Businesses and Hobbies patch and above, the Businesses and Hobbies DLC is not required)

----------------- Install With Vortex -----------------
- Install the archive itself using Vortex and follow the install instructions.

----------------- Main -----------------

Drag and drop all FOLDERS directly into your "The Sims 4/Mods" folder


1. It is very important that the mod_data folder be directly in the mods folder. The Sims 4/Mods/mod_data. 
	--Do not put it inside another folder. 
	--The rule for the mod_data folder is don't mess with the mod_data folder. 
	--Don't open the mod_data folder. 
	--Don't add anything into the mod_data folder. 
	--If you have done something to the mod_data folder and are getting an error about missing files, delete it and redownload. 

2a. Script files, (filename.ts4script) cannot be more than one folder deep inside the Mods folder. So, The Sims 4/Mods/filename.ts4script OR The Sims 4/Mods/Folder/filename.ts4script. You cannot add more folders or the script file will not function correctly or at all. 

2b. Package files, (filename.package) can be nested inside many folders. The Sims 4/Mods/Folder/Folder/Folder/Folder/filename.package is fine. 

2c. The exception to placing .package files in any folder: You should keep paired ts4script and package files together, so the deviousdesires.ts4script and deviousdesires.package files should be placed in the same location. 

3. When you update your mods, drag and drop (or use an unzip program and choose the The Sims 4/Mods folder as the target) all the files and folders in the download to the mods folder. It will overwrite only the things that need to be overwritten. 

	-- Don't delete your mod_data folder when you update. It contains your settings. Overwriting updates the files inside that need to be updated without messing with your saved settings. 


----------------- Troubleshooting Steps -----------------
Step 1: Remove all your Mods
Step 2: Install DD (version 5.14 or above)
-- Open the zip, drag n drop all folders and files directly into mods (Not in a subfolder)
Step 3: Ensure DD works
Step 4: Put back other mods.


-------- DDModules --------

Be sure to read this section! It contains information about various fetishes that are NOT required if you don't want them!


----------------- Module DLC/Mod Requirements -----------------
- DD Pets requires the Cats & Dogs DLC
- DD Dirty Play requires the Cats & Dogs DLC
- DD Pet Play requires the Cats & Dogs DLC, and Snowy Escape DLC
- DD Brothel requires the Dine Out, Get Famous, Discover University, and Get To Work DLCs
- DD Sexual Network requires Get Famous DLC
- DD Bees requires Seasons DLC

----------------- Module DLC/Mod Optionals -----------------
*These DLCs are NOT required, but some parts of the modules utilize them*
- DD Kinky optionally uses Realm of Magic (Spells) and Get Together (Clubs)
- DD Pets optionally uses My Wedding Stories (PetxHuman Weddings), Snowy Escape (Lifestyles), Get To Work (Serums), Cottage Living (Fox Sims), Horse Ranch (Horse Sims)
- DD Prostitution optionally uses Dream Home Decorator (Escort Career), Get Famous (Escort Career), and Discover University (Signing Bonus for Prostitute Career)
- DD Brothel optionally uses Romantic Garden Stuff (Stripper Seduction)
- DD Big Body Problems requires Lovestruck DLC (Likes/Dislikes)


----------------- Customization -----------------

Pick and choose the modules you would like in your game and copy them to your Mods folder.
If you choose to exclude all of the modules, Devious Desires will still contain at least basic sex and a few fetishes.
You don't need to install any of them if you don't want to!

Only install the modules you want enabled by default (Anything you install, may be disabled in-game afterwards, if you want it available, but not enabled for some reason.)

DD Anthros
- Anything specific to Anthro Sims, such as Werewolves.
- It also includes the rigs to allow Werewolves to work properly.

DD Bees
- Sims may transform into Bee Sims and produce Honey from their bodies (With DD Milk Farm).
  - Bee Sims are very good at gardening, but have their own unique behaviors and appearances.
  
DD Big Body Problems
- Sims have different cock sizes and other Sims can compliment/insult them. Shenanigans can occur during the daily lives of Sims with both Big or Small Cocks.

DD Pets
- Sex/Nudity for Teen through Elder Animal Sims (Dog, Cat, Fox, Dolphin, Chicken, Rabbit, Cow, Llama)

DD Kinky
- Rape and Rough Sex for Teen through Elder Human Sims (and Animal Sims, only if DD Pets is installed)
- Home Invasions - Rapists show up and rape Sims.
- Tentacle Infestations - Tentacles attack and rape Sims.

DD Milk Farm
- Breast Milking, Penis Milking, Breastfeeding, and Cum Eating for Teen through Elder Human Sims (and Animal Sims, only if DD Pets is installed)

DD Dirty Play
- Feces Consumption, Urine Consumption, Defecation On Objects/Sims, Urination On Objects/Sims for Teen through Elder Human Sims (and Animal Sims too, if DD Pets is installed)

DD Brothel
- The ability to buy and manage a brothel of Strippers, Harlots, and Studs and make money. These features are for Teen through Elder Human Sims (and Animal Sims, only if DD Pets is installed)

DD Pet Play
- The ability for Human Sims (Teen through Elder) to own/manage a Human Pet or to be Leashed by other Human Sims. They can be taken for walks and do their business too (With DD Dirty Play installed)

DD Prostitution
- Pimp out the body of your Sim and earn money, or become an Escort and satisfy clients around the neighborhood.

DD Sexual Network
- Create a profile, gain followers by uploading risque Adult pictures and videos.

DD Bees
- New Occult Bee Sims, Bee Sims are good at gardening and socializing.

DD Hotkeys
- Contains a number of Hotkeys that can be used to change positions of Sims, trigger orgasms, change animations, and undress Sims. (This module may cause some lag due to how it works)



----------------- Making it 'just work' -----------------

DDAnimations 
- A few animations are included to get you started. For more variety, look on Loverslab.com. All animations work with DD, regardless of their names. So even if an animator calls their animations, WW_filename, it plays on DD.

DDBody
- This includes penises, vaginas, nipples, and overlays to make them skin colored. This includes default skins to make sims appear nude in CAS. Also included are a belly overlay to hide muscles during belly inflation and a condom package. 

DDObjects
- Included is a pole for pole dancing animations.


DDRequirements
- CustomSliderFramework
	-- Change Height, Thigh Size, Breast Size, Body Size, Hand Size and more without going into CAS. This also allows belly inflation from the DD Milk Farm Module

- ModSettingsMenu
	-- Adds an interaction that allows you to configure the settings for all of your other mods in a single easy to find place. You will find these settings by pressing shift+ctrl+C and typing 'testingcheats on'. Then controlling a teen or older sim, shift-click on a teen or older sim and choose, 'ConfigureModSettings' This will allow you to access the settings for Devious Desires and every other CN mod. If you control or click on a child, toddler, or infant sim, you will be limited to the  settings for Safe for Work mods.

- Sims4CommunityLibrary
	-- This is a Safe for Work library of code that allows mods to be built more efficiently and simply, so mods can call on the commands housed in S4CL instead of rewriting them in every mod. This allows the game to slow down less with mods.

- DeviantCore
	-- This is a Not Safe for Work library of code that allows mods to be built more efficiently and simply, so mods can call on the commands housed in DC instead of rewriting them in every mod. This allows the game to slow down less with mods.

- Custom Gender Settings
	-- This is a Safe For Work mod that allows changing things such as Sexual Orientation, Sexual Organs, Voice, Voice Pitch, Genders, Pregnancy Settings, Breast Settings and more.

- The Other Custom Preferences Mod
    -- This is a Safe For Work mod that allows applying custom Likes/Dislikes in CAS.
	
- The More Universal Venue List
    -- This is a Safe For Work mod that allows showing custom Venues in the drop down for Venue Types when managing lots.



----------------- Other CN Mods -----------------

Control Menu
- Provides various commands to control various aspects about your Sims, their world, and objects in that world through a simple to use menu system.​ You can change buffs, traits, relationships (both relatives and like/dislike), household size limits, weather, pregnancy, revive ghosts, and much more.

	-- https://www.nexusmods.com/thesims4/mods/736

Autosave Mod
- A simple mod that will make an autosave after a set amount of time.

	-- https://www.nexusmods.com/thesims4/mods/1025

Pause on Load Zone
- A simple mod that will pause the game when you load into a zone, allowing you to take in the scenery before moving your Sims.

	-- https://www.nexusmods.com/thesims4/mods/1026

Customize Gender Settings
- Customize the Gender, Gender Options, Sexuality, and Voice of your Sims (or globally apply changes to all Sims) via an interaction, without needing to go into CAS.

	-- https://www.nexusmods.com/thesims4/mods/288

Outfit Customization
- Customize the Outfit of your Sim without going into CAS.

	-- https://www.nexusmods.com/thesims4/mods/289


----------------- Hotkeys -----------------
### Base Game
* 'Shift+Ctrl+Alt+X': Exit the game in a timely manner.
* 'Shift+Alt+C': Edit sim in CAS.

### Devious Desires
#### Love Control
* 'Shift+N': Progress to next animation for active sim if available or another random animation.
* 'Shift+O': Active sim gets an orgasm.
* 'Ctrl+O': Active sim triggers orgasms in all other 1-n sims within the current animation.
* 'Shift+Ctrl+O': Make all sims in animation happy.

### Outfits (Base Game & Devious Desires)
These should also work without DD using the Special outfit, at least to remove outfit parts.
* 'Shift+Q': Undress active sim.
* 'Alt+Q': Dress the active sim.
* 'Ctrl+Q': Undress all other sims in the social group.
* 'Shift+Ctrl+Q': Undress all sims in the social group, including the active sim.
* 'Shift+U': Undress all members during club gathering.
* 'H': Toggle heels / shoes

### Movement (Base Game & Devious Desires)
Rotation is (in this release only) supported around the vertical axis.

Instead of WASD / QE keys use the IJKL / TG keys. At least one control key must be help down for these keys to activate.

Rotate supports only J+K currently

Movement steps / rotation °
* Shift+Alt == 1 tile / 1m / 100°
* Alt == 25 cm / 25°
* Shift == 5 cm / 5°
* Ctrl == 1 cm / 1°
* Shift+Ctrl == 2 mm / 0.2°
* ---
* 'Shift+M': Toggle Absolute/Camera Movement Mode. Absolute is default and will move sims along the TS4 axis. Camera will move the sims left/right on the screen when pressing left/right.
* 'Shift+B': Toggle Move/Rotate. 
* ---
* 'Shift+I': Move Away (5 cm)
* 'Shift+K': Move Closer
* 'Shift+J': Move/Rotate Left
* 'Shift+L': Move/Rotate Right
* 'Shift+T': Move Up
* 'Shift+G': Move Down
* ---
* 'Ctrl+I': Move Away (1 cm)
* ... see above, there are many control key combinations available.


Credits:
Bee and Queen Bee Parts - Joan Campbell Beauty and Natalia-Auditore